1DS2760(3)                    One-Wire File System                    DS2760(3)
2
3
4

NAME

6       DS2760, DS2761, DS2762 - High-Precision Li+ Battery Monitor
7

SYNOPSIS

9   Temperature Voltage and Current.
10       30   [.]XXXXXXXXXXXX[XX][/[   amphours   |   current  |  currentbias  |
11       lock.[0-1|ALL] | memory | pages/page.[0-1|ALL] | PIO | sensed | temper‐
12       ature | vbias | vis | volt | volthours |
13       cc | ce | coc | defaultpmod | defaultswen | dc | de | doc | mstr | ov |
14       ps | pmod | swen | uv |
15       address | crc8 | id | locator | r_address | r_id | r_locator | type ]]
16
17   Thermocouple
18       30   [.]XXXXXXXXXXXX[XX][/[    temperature    |    typeX/range_low    |
19       typeX/range_high | typeX/temperature ]]
20
21   Weather Station
22       30   [.]XXXXXXXXXXXX[XX][/[   WS603/temperature  |  WS603/wind_speed  |
23       WS603/direction | WS603/volt |
24       WS603/LED/status | WS603/LED/control.ALL | WS603/LED/model |
25       WS603/calibrationwind_speed | WS603/calibration/direction |
26       WS603/light/intensity | WS603/light/threshold
27

FAMILY CODE

29       30
30

SPECIAL PROPERTIES

32   amphours
33       read-write, floating point
34       Accumulated amperage read  by  current  sensor.  Units  are  in  Amp-hr
35       (Assumes internal 25mOhm resistor). Derived from volthours / Rinternal.
36       Formally amphours is the integral of current - currentbias over time.
37
38   current
39       read-only, floating point
40       Current  reading. Units are in Amp (Assumes internal 25 mOhm resistor).
41       Derived from vis / Rinternal.
42
43   currentbias
44       read-write, floating point
45       Fixed offset applied to each current measurement. Used in the  amphours
46       value.  Assumes  internal 25mOhm resistor. Units are Amp and range from
47       -.08A to .08A.
48       Derived from vbias / Rinternal.
49
50   lock.[0-1|ALL]
51       read-write, yes-no
52       Lock either of the two eprom pages to prevent  further  writes.  Appar‐
53       ently setting lock is permanent.
54
55   memory
56       read-write, binary
57       Access  to  the  full  256  byte  memory  range.  Much of this space is
58       reserved or special use. User space is the page area.
59       See the DATASHEET for a full memory map.
60
61   pages/pages.[0-1|ALL]
62       read-write, binary Two 16 byte areas of memory  for  user  application.
63       The lock property can prevent further alteration.
64       NOTE that the page property is different from the common OWFS implemen‐
65       tation in that all of memory is not accessible.
66
67   PIO
68       write-only, yes-no
69       Controls the PIO pin allowing external switching.
70       Writing "1" turns the PIO pin on (conducting). Writing  "0"  makes  the
71       pin  non-conducting.  The logical state of the voltage can be read with
72       the sensed property. This will reflect the current voltage at the  pin,
73       not the value sent to PIO
74       Note  also  that  PIO  will  also be altered by the power-status of the
75       DS2670 See the datasheet for details.
76
77   sensed
78       read-only, yes-no
79       The logical voltage at the PIO pin. Useful only if the PIO property  is
80       set to "0" (non-conducting).
81       Value will be 0 or 1 depending on the voltage threshold.
82
83   temperature
84       read-only, floating point
85       Temperature  read  by the chip at high resolution (~13 bits). Units are
86       selected from the invoking command line. See owfs(1) or owhttpd(1)  for
87       choices. Default is Celsius.
88       Conversion is continuous.
89
90   vbias
91       read-write, floating point
92       Fixed  offset  applied  to each vis measurement. Used for the volthours
93       value. Units are in Volts.
94       Range -2.0mV to 2.0mV
95
96   vis
97       read-only, floating point
98       Current sensor reading (unknown external resistor). Measures the  volt‐
99       age gradient between the Vis pins. Units are in Volts
100       The  vis  readings  are  integrated  over time to provide the volthours
101       property.
102       The current reading is derived from vis assuming the internal  25  mOhm
103       resistor is employed. There is no way to know this through software.
104
105   volt
106       read-only, floating point
107       Voltage  read  at  the  voltage  sensor;. This is separate from the vis
108       voltage that is used for current measurement. Units are Volts
109       Range is between 0 and 4.75V
110
111   volthours
112       read-write, floating point
113       Integral of vis - vbias over time. Units are in volthours
114

THERMOCOUPLE

116   typeX/
117       directory
118       Thermocouple circuit using the DS2760 to read the Seebeck  voltage  and
119       the  reference temperature. Since the type interpretation of the values
120       read depends on the type of thermocouple, the correct directory must be
121       chosen.  Supported thermocouple types include types B, E, J, K, N, R, S
122       and T.
123
124   typeX/range_low typeX/ranges_high
125       read-only, flaoting point
126       The lower and upper temperature  supported  by  this  thermocouple  (at
127       least  by  the conversion routines). In the globally chosen temperature
128       units.
129
130   typeX/temperature
131       read-only, floating point
132       Thermocouple temperature. Requires a voltage  and  temperature  conver‐
133       sion. Returned in globally chosen temperature units.
134       Note:  there  are  two  types of temperature measurements possible. The
135       temperature value in the main device directory is the reference temper‐
136       ature  read  at the chip. The typeX/temperature value is at the thermo‐
137       couple junction, probably remote from the chip.
138

WEATHER STATION

140   WS603
141       directory
142       Weather station from AAG electronica that  includes  temperature,  wind
143       speed, wind direction, light sensor and LED lights.
144
145   WS603/temperature
146       read-only, floating-point
147       Uses  the DS2760 temperature sensor. This is equivalent to the tempera‐
148       ture value. Again in the specificed temperature scale, default Celsius.
149
150   WS603/wind_speed
151       read_only, floating-point
152       Readings  from  the   anometer,   scaled   using   the   WS603/calibra‐
153       tion/wind_speed
154
155   WS603/direction
156       read_only, unsigned integer
157       Wind direction, using the following table
158
159       1      N
160
161       2      NNE
162
163       3      NE
164
165       4      NEE
166
167       5      E
168
169       6      EES
170
171       7      ES
172
173       8      ESS
174
175       9      S
176
177       10     SSW
178
179       11     SW
180
181       12     SWW
182
183       13     W
184
185       14     WWN
186
187       15     WN
188
189       16     WWN
190
191       Values  are  adjusted  (internally)  by the WS603/calibration/direction
192       property
193
194   WS603/volt
195       read-only, unsigned integer
196       Voltage value from the WS603 device. Units and significance is unclear.
197
198   WS603/calibration/wind_speed
199       read-write, unsigned integer
200       Value between 1 and 200 for wind speed scaling. Values on of this range
201       are ignored and the default value of 100 used.
202
203   WS603/calibration/direction
204       read-write, unsigned integer
205       Adjustment of wind direction. See datasheet.
206
207   WS603/light/intensity
208       read-only, unsigned integer
209       Uncalibrated  value  from an internal light sensor. Used for control of
210       LED display (daytime vs nighttime).
211
212   WS603/light/threshold
213       read-only, unsigned integer
214       Threshold for internal light sensor. Used for control  of  LED  display
215       (daytime vs nighttime).
216
217       Value is set as value 4 of the array passed to WS603/LED/control
218
219   WS603/LED/status
220       read-only, unsigned integer
221       Status of LED lights intensities. See datasheet.
222
223       Value is set as values 2 and 3 of the array passed to WS603/LED/control
224
225   WS603/LED/model
226       read-only, unsigned integer
227       What factors control LED display. See datasheet.
228
229       Value is set as value 1 of the array passed to WS603/LED/control.ALL
230
231   WS603/LED/model
232       write-only, unsigned integer array of 4 values
233       Four  integers  sent  to  control  LED display. All four values must be
234       sent, comma separated.
235
236       0      Light mode
237
238       1      Light status
239
240       2      Light level
241
242       3      Light threshold
243

OBSCURE PROPERTIES

245   cc ce coc dc de doc mstr ov pmod swen uv
246       varies, yes-no
247       Bit flags corresponding to various battery management functions of  the
248       chip. See the DATASHEET for details of the identically named entries.
249       In general, writing "0" corresponds to a 0 bit value, and non-zero cor‐
250       responds to a 1 bit value.
251
252   defaultpmod defaultswen
253       read-write, yes-no
254       Default power-on state for the corresponding properties.
255

STANDARD PROPERTIES

257   address
258   r_address
259       read-only, ascii
260       The entire 64-bit unique ID. Given as  upper  case  hexidecimal  digits
261       (0-9A-F).
262       address starts with the family code
263       r address is the address in reverse order, which is often used in other
264       applications and labeling.
265
266   crc8
267       read-only, ascii
268       The 8-bit error correction portion. Uses cyclic redundancy check.  Com‐
269       puted  from  the  preceding  56  bits of the unique ID number. Given as
270       upper case hexidecimal digits (0-9A-F).
271
272   family
273       read-only, ascii
274       The 8-bit family code. Unique to each type of device.  Given  as  upper
275       case hexidecimal digits (0-9A-F).
276
277   id
278   r_id
279       read-only, ascii
280       The 48-bit middle portion of the unique ID number. Does not include the
281       family code or CRC. Given as upper case hexidecimal digits (0-9A-F).
282       r id is the id in reverse order, which is often used in other  applica‐
283       tions and labeling.
284
285   locator
286   r_locator
287       read-only, ascii
288       Uses  an  extension  of the 1-wire design from iButtonLink company that
289       associated 1-wire physical connections with a unique  1-wire  code.  If
290       the  connection is behind a Link Locator the locator will show a unique
291       8-byte number (16 character hexidecimal) starting with family code FE.
292       If no Link Locator is between the device and the  master,  the  locator
293       field will be all FF.
294       r locator is the locator in reverse order.
295
296   present (DEPRECATED)
297       read-only, yes-no
298       Is the device currently present on the 1-wire bus?
299
300   type
301       read-only, ascii
302       Part  name  assigned by Dallas Semi. E.g.  DS2401 Alternative packaging
303       (iButton vs chip) will not be distiguished.
304

ALARMS

306       None.
307

DESCRIPTION

309   1-Wire
310       1-wire is a wiring protocol and series of devices designed and manufac‐
311       tured  by  Dallas  Semiconductor, Inc. The bus is a low-power low-speed
312       low-connector scheme where the data line can also provide power.
313
314       Each device is uniquely and unalterably  numbered  during  manufacture.
315       There  are a wide variety of devices, including memory, sensors (humid‐
316       ity, temperature, voltage, contact, current), switches, timers and data
317       loggers.  More complex devices (like thermocouple sensors) can be built
318       with these basic devices. There  are  also  1-wire  devices  that  have
319       encryption included.
320
321       The  1-wire  scheme uses a single bus master and multiple slaves on the
322       same wire. The bus master initiates all communication. The  slaves  can
323       be individually discovered and addressed using their unique ID.
324
325       Bus  masters come in a variety of configurations including serial, par‐
326       allel, i2c, network or USB adapters.
327
328   OWFS design
329       OWFS is a suite of programs that designed to make the  1-wire  bus  and
330       its  devices easily accessible. The underlying principle is to create a
331       virtual filesystem, with the unique ID being  the  directory,  and  the
332       individual  properties  of  the  device are represented as simple files
333       that can be read and written.
334
335       Details of the individual slave or master design are  hidden  behind  a
336       consistent interface. The goal is to provide an easy set of tools for a
337       software designer to create monitoring or control  applications.  There
338       are some performance enhancements in the implementation, including data
339       caching, parallel access to bus masters, and aggregation of device com‐
340       munication.  Still the fundemental goal has been ease of use, flexibil‐
341       ity and correctness rather than speed.
342
343   DS2760 DS2761 DS2762
344       The DS2760 (3) is a class of battery charging  controllers.  There  are
345       minor hardware difference between the DS2760, DS2761 and DS2762 battery
346       chip, but they are indistiguishable to the software.
347
348       A number of interesting devices can be built with the DS276x  including
349       thermocouples.  Support  for  thermocouples in built into the software,
350       using the embedded thermister as the cold junction temperature.
351
352       For an explanation of the differences between the DS276x variants,  see
353       Dallas Application Note 221.
354

ADDRESSING

356       All  1-wire  devices are factory assigned a unique 64-bit address. This
357       address is of the form:
358
359       Family Code
360              8 bits
361
362       Address
363              48 bits
364
365       CRC    8 bits
366
367       Addressing under OWFS is in hexidecimal, of form:
368
369              01.123456789ABC
370
371       where 01 is an example 8-bit family code, and 12345678ABC is an example
372       48 bit address.
373
374       The  dot  is  optional,  and the CRC code can included. If included, it
375       must be correct.
376

DATASHEET

378       http://pdfserv.maxim-ic.com/en/ds/DS2760.pdf
379       http://pdfserv.maxim-ic.com/en/an/app221.pdf
380       http://www.aag.com.mx/aagusa/contents/en-us/Descrip
381       tion%20of%20WSV3%20Interface%20(1-wire).pdf
382

SEE ALSO

384   Programs
385       owfs  (1)  owhttpd  (1)  owftpd  (1)  owserver (1) owdir (1) owread (1)
386       owwrite (1) owpresent (1) owtap (1)
387
388   Configuration and testing
389       owfs (5) owtap (1) owmon (1)
390
391   Language bindings
392       owtcl (3) owperl (3) owcapi (3)
393
394   Clocks
395       DS1427 (3) DS1904 (3) DS1994 (3) DS2404  (3)  DS2404S  (3)  DS2415  (3)
396       DS2417 (3)
397
398   ID
399       DS2401 (3) DS2411 (3) DS1990A (3)
400
401   Memory
402       DS1982  (3)  DS1985  (3)  DS1986  (3)  DS1991 (3) DS1992 (3) DS1993 (3)
403       DS1995 (3) DS1996 (3) DS2430A (3) DS2431  (3)  DS2433  (3)  DS2502  (3)
404       DS2506 (3) DS28E04 (3) DS28EC20 (3)
405
406   Switches
407       DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
408
409   Temperature
410       DS1822  (3)  DS1825  (3)  DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
411       DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065  (3)
412       EDS0066  (3)  EDS0067  (3) EDS0068 (3) EDS0071 (3) EDS0072 (3) MAX31826
413       (3)
414
415   Humidity
416       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
417
418   Voltage
419       DS2450 (3)
420
421   Resistance
422       DS2890 (3)
423
424   Multifunction (current, voltage, temperature)
425       DS2436 (3) DS2437 (3) DS2438 (3)  DS2751  (3)  DS2755  (3)  DS2756  (3)
426       DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
427
428   Counter
429       DS2423 (3)
430
431   LCD Screen
432       LCD (3) DS2408 (3)
433
434   Crypto
435       DS1977 (3)
436
437   Pressure
438       DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
439
440   Moisture
441       EEEF (3) DS2438 (3)
442

AVAILABILITY

444       http://www.owfs.org
445

AUTHOR

447       Paul Alfille (paul.alfille@gmail.com)
448
449
450
451OWFS Manpage                         2003                            DS2760(3)
Impressum