sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget /translations/zh_CN/hwmon/ds1621modnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/zh_TW/hwmon/ds1621modnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/it_IT/hwmon/ds1621modnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ja_JP/hwmon/ds1621modnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ko_KR/hwmon/ds1621modnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/pt_BR/hwmon/ds1621modnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/sp_SP/hwmon/ds1621modnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(hKernel driver ds1621h]hKernel driver ds1621}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhh:/var/lib/git/docbuild/linux/Documentation/hwmon/ds1621.rsthKubh paragraph)}(hSupported chips:h]hSupported chips:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh block_quote)}(hXk* Dallas Semiconductor / Maxim Integrated DS1621 Prefix: 'ds1621' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1621.pdf * Dallas Semiconductor DS1625 Prefix: 'ds1625' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1620.pdf * Maxim Integrated DS1631 Prefix: 'ds1631' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdf * Maxim Integrated DS1721 Prefix: 'ds1721' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1721.pdf * Maxim Integrated DS1731 Prefix: 'ds1731' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdf h]h bullet_list)}(hhh](h list_item)}(hDallas Semiconductor / Maxim Integrated DS1621 Prefix: 'ds1621' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1621.pdf h](h)}(h.Dallas Semiconductor / Maxim Integrated DS1621h]h.Dallas Semiconductor / Maxim Integrated DS1621}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubh)}(hPrefix: 'ds1621'h]hPrefix: ‘ds1621’}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubh)}(hAddresses scanned: noneh]hAddresses scanned: none}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhubh)}(hYDatasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1621.pdfh](h Datasheet: }(hjhhhNhNubh reference)}(hNhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1621.pdfh]hNhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1621.pdf}(hj hhhNhNubah}(h]h ]h"]h$]h&]refurij"uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhhhK hhubeh}(h]h ]h"]h$]h&]uh1hhhubh)}(hDallas Semiconductor DS1625 Prefix: 'ds1625' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1620.pdf h](h)}(hDallas Semiconductor DS1625h]hDallas Semiconductor DS1625}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj;ubh)}(hPrefix: 'ds1625'h]hPrefix: ‘ds1625’}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj;ubh)}(hAddresses scanned: noneh]hAddresses scanned: none}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj;ubh)}(hYDatasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1620.pdfh](h Datasheet: }(hjihhhNhNubj)}(hNhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1620.pdfh]hNhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1620.pdf}(hjqhhhNhNubah}(h]h ]h"]h$]h&]refurijsuh1jhjiubeh}(h]h ]h"]h$]h&]uh1hhhhKhj;ubeh}(h]h ]h"]h$]h&]uh1hhhubh)}(hMaxim Integrated DS1631 Prefix: 'ds1631' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdf h](h)}(hMaxim Integrated DS1631h]hMaxim Integrated DS1631}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hPrefix: 'ds1631'h]hPrefix: ‘ds1631’}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hAddresses scanned: noneh]hAddresses scanned: none}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(h`Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdfh](h Datasheet: }(hjhhhNhNubj)}(hUhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdfh]hUhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdf}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1hhhubh)}(hMaxim Integrated DS1721 Prefix: 'ds1721' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1721.pdf h](h)}(hMaxim Integrated DS1721h]hMaxim Integrated DS1721}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hPrefix: 'ds1721'h]hPrefix: ‘ds1721’}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjubh)}(hAddresses scanned: noneh]hAddresses scanned: none}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK"hjubh)}(hYDatasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1721.pdfh](h Datasheet: }(hj hhhNhNubj)}(hNhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1721.pdfh]hNhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1721.pdf}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhj ubeh}(h]h ]h"]h$]h&]uh1hhhhK$hjubeh}(h]h ]h"]h$]h&]uh1hhhubh)}(hMaxim Integrated DS1731 Prefix: 'ds1731' Addresses scanned: none Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdf h](h)}(hMaxim Integrated DS1731h]hMaxim Integrated DS1731}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hj.ubh)}(hPrefix: 'ds1731'h]hPrefix: ‘ds1731’}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK(hj.ubh)}(hAddresses scanned: noneh]hAddresses scanned: none}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK*hj.ubh)}(h`Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdfh](h Datasheet: }(hj\hhhNhNubj)}(hUhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdfh]hUhttps://www.analog.com/media/en/technical-documentation/data-sheets/DS1631-DS1731.pdf}(hjdhhhNhNubah}(h]h ]h"]h$]h&]refurijfuh1jhj\ubeh}(h]h ]h"]h$]h&]uh1hhhhK,hj.ubeh}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]bullet*uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubhdefinition_list)}(hhh]hdefinition_list_item)}(hAuthors: - Christian W. Zuckschwerdt - valuable contributions by Jan M. Sendler - ported to 2.6 by Aurelien Jarno with the help of Jean Delvare h](hterm)}(hAuthors:h]hAuthors:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhK2hjubh definition)}(hhh]h)}(hhh](h)}(h)Christian W. Zuckschwerdt h]h)}(hjh](hChristian W. Zuckschwerdt <}(hjhhhNhNubj)}(h zany@triq.neth]h zany@triq.net}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:zany@triq.netuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK/hjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(h=valuable contributions by Jan M. Sendler h]h)}(hjh](h*valuable contributions by Jan M. Sendler <}(hjhhhNhNubj)}(hsendler@sendler.deh]hsendler@sendler.de}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:sendler@sendler.deuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(hhported to 2.6 by Aurelien Jarno with the help of Jean Delvare h]h)}(hgported to 2.6 by Aurelien Jarno with the help of Jean Delvare h](h!ported to 2.6 by Aurelien Jarno <}(hj hhhNhNubj)}(haurelien@aurel32.neth]haurelien@aurel32.net}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:aurelien@aurel32.netuh1jhj ubh!> with the help of Jean Delvare <}(hj hhhNhNubj)}(hjdelvare@suse.deh]hjdelvare@suse.de}(hj&hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:jdelvare@suse.deuh1jhj ubh>}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK1hjubah}(h]h ]h"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]j-uh1hhhhK/hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhK2hjubah}(h]h ]h"]h$]h&]uh1jhhhhhNhNubh)}(hhh](h)}(hModule Parametersh]hModule Parameters}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hhhhhK5ubh)}(hhh]h)}(hEpolarity int Output's polarity: * 0 = active high, * 1 = active low h](h)}(hpolarity int Output's polarity:h]h!polarity int Output’s polarity:}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjsubh)}(hhh](h)}(h0 = active high,h]h)}(hjh]h0 = active high,}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(h1 = active low h]h)}(h1 = active lowh]h1 = active low}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hjubah}(h]h ]h"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]jjuh1hhhhK:hjsubeh}(h]h ]h"]h$]h&]uh1hhjphhhNhNubah}(h]h ]h"]h$]h&]jjuh1hhhhK7hj_hhubeh}(h]module-parametersah ]h"]module parametersah$]h&]uh1hhhhhhhhK5ubh)}(hhh](h)}(h Descriptionh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK>ubh)}(hXThe DS1621 is a (one instance) digital thermometer and thermostat. It has both high and low temperature limits which can be user defined (i.e. programmed into non-volatile on-chip registers). Temperature range is -55 degree Celsius to +125 in 0.5 increments. You may convert this into a Fahrenheit range of -67 to +257 degrees with 0.9 steps. If polarity parameter is not provided, original value is used.h]hXThe DS1621 is a (one instance) digital thermometer and thermostat. It has both high and low temperature limits which can be user defined (i.e. programmed into non-volatile on-chip registers). Temperature range is -55 degree Celsius to +125 in 0.5 increments. You may convert this into a Fahrenheit range of -67 to +257 degrees with 0.9 steps. If polarity parameter is not provided, original value is used.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjhhubh)}(hXAs for the thermostat, behavior can also be programmed using the polarity toggle. On the one hand ("heater"), the thermostat output of the chip, Tout, will trigger when the low limit temperature is met or underrun and stays high until the high limit is met or exceeded. On the other hand ("cooler"), vice versa. That way "heater" equals "active low", whereas "conditioner" equals "active high". Please note that the DS1621 data sheet is somewhat misleading in this point since setting the polarity bit does not simply invert Tout.h]hX*As for the thermostat, behavior can also be programmed using the polarity toggle. On the one hand (“heater”), the thermostat output of the chip, Tout, will trigger when the low limit temperature is met or underrun and stays high until the high limit is met or exceeded. On the other hand (“cooler”), vice versa. That way “heater” equals “active low”, whereas “conditioner” equals “active high”. Please note that the DS1621 data sheet is somewhat misleading in this point since setting the polarity bit does not simply invert Tout.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjhhubh)}(hXA second thing is that, during extensive testing, Tout showed a tolerance of up to +/- 0.5 degrees even when compared against precise temperature readings. Be sure to have a high vs. low temperature limit gap of al least 1.0 degree Celsius to avoid Tout "bouncing", though!h]hXA second thing is that, during extensive testing, Tout showed a tolerance of up to +/- 0.5 degrees even when compared against precise temperature readings. Be sure to have a high vs. low temperature limit gap of al least 1.0 degree Celsius to avoid Tout “bouncing”, though!}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhjhhubh)}(hThe alarm bits are set when the high or low limits are met or exceeded and are reset by the module as soon as the respective temperature ranges are left.h]hThe alarm bits are set when the high or low limits are met or exceeded and are reset by the module as soon as the respective temperature ranges are left.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKUhjhhubh)}(hXEThe alarm registers are in no way suitable to find out about the actual status of Tout. They will only tell you about its history, whether or not any of the limits have ever been met or exceeded since last power-up or reset. Be aware: When testing, it showed that the status of Tout can change with neither of the alarms set.h]hXEThe alarm registers are in no way suitable to find out about the actual status of Tout. They will only tell you about its history, whether or not any of the limits have ever been met or exceeded since last power-up or reset. Be aware: When testing, it showed that the status of Tout can change with neither of the alarms set.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhjhhubh)}(hXSince there is no version or vendor identification register, there is no unique identification for these devices. Therefore, explicit device instantiation is required for correct device identification and functionality (one device per address in this address range: 0x48..0x4f).h]hXSince there is no version or vendor identification register, there is no unique identification for these devices. Therefore, explicit device instantiation is required for correct device identification and functionality (one device per address in this address range: 0x48..0x4f).}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK_hjhhubh)}(hThe DS1625 is pin compatible and functionally equivalent with the DS1621, but the DS1621 is meant to replace it. The DS1631, DS1721, and DS1731 are also pin compatible with the DS1621 and provide multi-resolution support.h]hThe DS1625 is pin compatible and functionally equivalent with the DS1621, but the DS1621 is meant to replace it. The DS1631, DS1721, and DS1731 are also pin compatible with the DS1621 and provide multi-resolution support.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKdhjhhubh)}(hXAdditionally, the DS1721 data sheet says the temperature flags (THF and TLF) are used internally, however, these flags do get set and cleared as the actual temperature crosses the min or max settings (which by default are set to 75 and 80 degrees respectively).h]hXAdditionally, the DS1721 data sheet says the temperature flags (THF and TLF) are used internally, however, these flags do get set and cleared as the actual temperature crosses the min or max settings (which by default are set to 75 and 80 degrees respectively).}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhjhhubeh}(h] descriptionah ]h"] descriptionah$]h&]uh1hhhhhhhhK>ubh)}(hhh](h)}(hTemperature Conversionh]hTemperature Conversion}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZhhhhhKnubh)}(hhh](h)}(h4DS1621 - 750ms (older devices may take up to 1000ms)h]h)}(hjph]h4DS1621 - 750ms (older devices may take up to 1000ms)}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphjnubah}(h]h ]h"]h$]h&]uh1hhjkhhhhhNubh)}(hDS1625 - 500msh]h)}(hjh]hDS1625 - 500ms}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKqhjubah}(h]h ]h"]h$]h&]uh1hhjkhhhhhNubh)}(h=DS1631 - 93ms..750ms for 9..12 bits resolution, respectively.h]h)}(hjh]h=DS1631 - 93ms..750ms for 9..12 bits resolution, respectively.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjubah}(h]h ]h"]h$]h&]uh1hhjkhhhhhNubh)}(h=DS1721 - 93ms..750ms for 9..12 bits resolution, respectively.h]h)}(hjh]h=DS1721 - 93ms..750ms for 9..12 bits resolution, respectively.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjubah}(h]h ]h"]h$]h&]uh1hhjkhhhhhNubh)}(h>DS1731 - 93ms..750ms for 9..12 bits resolution, respectively. h]h)}(h=DS1731 - 93ms..750ms for 9..12 bits resolution, respectively.h]h=DS1731 - 93ms..750ms for 9..12 bits resolution, respectively.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthjubah}(h]h ]h"]h$]h&]uh1hhjkhhhhhNubeh}(h]h ]h"]h$]h&]jjLuh1hhhhKphjZhhubh)}(h{Note: On the DS1621, internal access to non-volatile registers may last for 10ms or less (unverified on the other devices).h]h{Note: On the DS1621, internal access to non-volatile registers may last for 10ms or less (unverified on the other devices).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKvhjZhhubeh}(h]temperature-conversionah ]h"]temperature conversionah$]h&]uh1hhhhhhhhKnubh)}(hhh](h)}(hTemperature Accuracyh]hTemperature Accuracy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK{ubh)}(hhh](h)}(h6DS1621: +/- 0.5 degree Celsius (from 0 to +70 degrees)h]h)}(hjh]h6DS1621: +/- 0.5 degree Celsius (from 0 to +70 degrees)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK}hjubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(h6DS1625: +/- 0.5 degree Celsius (from 0 to +70 degrees)h]h)}(hj+h]h6DS1625: +/- 0.5 degree Celsius (from 0 to +70 degrees)}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hj)ubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(h6DS1631: +/- 0.5 degree Celsius (from 0 to +70 degrees)h]h)}(hjBh]h6DS1631: +/- 0.5 degree Celsius (from 0 to +70 degrees)}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj@ubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(h8DS1721: +/- 1.0 degree Celsius (from -10 to +85 degrees)h]h)}(hjYh]h8DS1721: +/- 1.0 degree Celsius (from -10 to +85 degrees)}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjWubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(h9DS1731: +/- 1.0 degree Celsius (from -10 to +85 degrees) h]h)}(h8DS1731: +/- 1.0 degree Celsius (from -10 to +85 degrees)h]h8DS1731: +/- 1.0 degree Celsius (from -10 to +85 degrees)}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjnubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubeh}(h]h ]h"]h$]h&]jjLuh1hhhhK}hjhhubhnote)}(hIPlease refer to the device datasheets for accuracy at other temperatures.h]h)}(hjh]hIPlease refer to the device datasheets for accuracy at other temperatures.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]temperature-accuracyah ]h"]temperature accuracyah$]h&]uh1hhhhhhhhK{ubh)}(hhh](h)}(hTemperature Resolution:h]hTemperature Resolution:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hAs mentioned above, the DS1631, DS1721, and DS1731 provide multi-resolution support, which is achieved via the R0 and R1 config register bits, where:h]hAs mentioned above, the DS1631, DS1721, and DS1731 provide multi-resolution support, which is achieved via the R0 and R1 config register bits, where:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]temperature-resolutionah ]h"]temperature resolution:ah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hR0..R1h]hR0..R1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubhthead)}(hhh]hrow)}(hhh](hentry)}(hhh]h)}(hR0h]hR0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hR1h]hR1}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj2ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubhtbody)}(hhh](j)}(hhh](j)}(hhh]h)}(h0h]h0}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjfubah}(h]h ]h"]h$]h&]uh1jhjcubj)}(hhh]h)}(hjkh]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj}ubah}(h]h ]h"]h$]h&]uh1jhjcubj)}(hhh]h)}(h9 bits, 0.5 degrees Celsiush]h9 bits, 0.5 degrees Celsius}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhj`ubj)}(hhh](j)}(hhh]h)}(h1h]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hjkh]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h10 bits, 0.25 degrees Celsiush]h10 bits, 0.25 degrees Celsius}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj`ubj)}(hhh](j)}(hhh]h)}(hjkh]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hjh]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h11 bits, 0.125 degrees Celsiush]h11 bits, 0.125 degrees Celsius}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj`ubj)}(hhh](j)}(hhh]h)}(hjh]h1}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjLubah}(h]h ]h"]h$]h&]uh1jhjIubj)}(hhh]h)}(hjh]h1}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjbubah}(h]h ]h"]h$]h&]uh1jhjIubj)}(hhh]h)}(h12 bits, 0.0625 degrees Celsiush]h12 bits, 0.0625 degrees Celsius}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjxubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1j^hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hEAt initial device power-on, the default resolution is set to 12-bits.h]h)}(hjh]hEAt initial device power-on, the default resolution is set to 12-bits.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(hX The resolution mode for the DS1631, DS1721, or DS1731 can be changed from userspace, via the device 'update_interval' sysfs attribute. This attribute will normalize the range of input values to the device maximum resolution values defined in the datasheet as follows:h]hXThe resolution mode for the DS1631, DS1721, or DS1731 can be changed from userspace, via the device ‘update_interval’ sysfs attribute. This attribute will normalize the range of input values to the device maximum resolution values defined in the datasheet as follows:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh]j)}(hhh](j)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh](j)}(hhh](j)}(hhh]h)}(h Resolutionh]h Resolution}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hConversion Timeh]hConversion Time}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h Input Rangeh]h Input Range}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj%ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h(C/LSB)h]h(C/LSB)}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjEubah}(h]h ]h"]h$]h&]uh1jhjBubj)}(hhh]h)}(h(msec)h]h(msec)}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj\ubah}(h]h ]h"]h$]h&]uh1jhjBubj)}(hhh]h)}(h(msec)h]h(msec)}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjsubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj_)}(hhh](j)}(hhh](j)}(hhh]h)}(h0.5h]h0.5}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h93.75h]h93.75}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h0....94h]h0....94}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0.25h]h0.25}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h187.5h]h187.5}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h95...187h]h95...187}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0.125h]h0.125}(hj; hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj8 ubah}(h]h ]h"]h$]h&]uh1jhj5 ubj)}(hhh]h)}(h375h]h375}(hjR hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjO ubah}(h]h ]h"]h$]h&]uh1jhj5 ubj)}(hhh]h)}(h188..375h]h188..375}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjf ubah}(h]h ]h"]h$]h&]uh1jhj5 ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0.0625h]h0.0625}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h750h]h750}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h 376..infinityh]h 376..infinity}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j^hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(hkThe following examples show how the 'update_interval' attribute can be used to change the conversion time::h]hnThe following examples show how the ‘update_interval’ attribute can be used to change the conversion time:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh literal_block)}(hXu$ cat update_interval 750 $ cat temp1_input 22062 $ $ echo 300 > update_interval $ cat update_interval 375 $ cat temp1_input 22125 $ $ echo 150 > update_interval $ cat update_interval 188 $ cat temp1_input 22250 $ $ echo 1 > update_interval $ cat update_interval 94 $ cat temp1_input 22000 $ $ echo 1000 > update_interval $ cat update_interval 750 $ cat temp1_input 22062 $h]hXu$ cat update_interval 750 $ cat temp1_input 22062 $ $ echo 300 > update_interval $ cat update_interval 375 $ cat temp1_input 22125 $ $ echo 150 > update_interval $ cat update_interval 188 $ cat temp1_input 22250 $ $ echo 1 > update_interval $ cat update_interval 94 $ cat temp1_input 22000 $ $ echo 1000 > update_interval $ cat update_interval 750 $ cat temp1_input 22062 $}hj sbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1j hhhKhjhhubh)}(hAs shown, the ds1621 driver automatically adjusts the 'update_interval' user input, via a step function. Reading back the 'update_interval' value after a write operation provides the conversion time used by the device.h]hAs shown, the ds1621 driver automatically adjusts the ‘update_interval’ user input, via a step function. Reading back the ‘update_interval’ value after a write operation provides the conversion time used by the device.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hbMathematically, the resolution can be derived from the conversion time via the following function:h]hbMathematically, the resolution can be derived from the conversion time via the following function:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h)g(x) = 0.5 * [minimum_conversion_time/x] h]h)}(h(g(x) = 0.5 * [minimum_conversion_time/x]h]h(g(x) = 0.5 * [minimum_conversion_time/x]}(hj$ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hwhere:h]hwhere:}(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h}- 'x' = the output from 'update_interval' - 'g(x)' = the resolution in degrees C per LSB. - 93.75ms = minimum conversion timeh]h)}(hhh](h)}(h''x' = the output from 'update_interval'h]h)}(hjO h]h/‘x’ = the output from ‘update_interval’}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjM ubah}(h]h ]h"]h$]h&]uh1hhjJ ubh)}(h-'g(x)' = the resolution in degrees C per LSB.h]h)}(hjf h]h1‘g(x)’ = the resolution in degrees C per LSB.}(hjh hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjd ubah}(h]h ]h"]h$]h&]uh1hhjJ ubh)}(h!93.75ms = minimum conversion timeh]h)}(hj} h]h!93.75ms = minimum conversion time}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj{ ubah}(h]h ]h"]h$]h&]uh1hhjJ ubeh}(h]h ]h"]h$]h&]jjLuh1hhhhKhjF ubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]r0-r1ah ]h"]r0..r1ah$]h&]uh1hhhhhhhhKubeh}(h]kernel-driver-ds1621ah ]h"]kernel driver ds1621ah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehʌ _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j j jjjWjTjjjjjjj j u nametypes}(j jjWjjjj uh}(j hjj_jTjjjZjjjjj ju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.