1DS2760(3) One-Wire File System DS2760(3)
2
6 DS2760, DS2761, DS2762 - High-Precision Li+ Battery Monitor
7
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 Thermocouple
18 30 [.]XXXXXXXXXXXX[XX][/[ temperature | typeX/range_low |
19 typeX/range_high | typeX/temperature ]]
20 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
29 30
30
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 current
39 read-only, floating point
40 Current reading. Units are in Amp (Assumes internal 25 mOhm resistor).
41 Derived from vis / Rinternal.
42 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 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 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 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 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 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 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 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 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 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 volthours
112 read-write, floating point
113 Integral of vis - vbias over time. Units are in volthours
114
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 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 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
140 WS603
141 directory
142 Weather station from AAG electronica that includes temperature, wind
143 speed, wind direction, light sensor and LED lights.
144 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 WS603/wind_speed
151 read_only, floating-point
152 Readings from the anometer, scaled using the WS603/calibra‐
153 tion/wind_speed
154 WS603/direction
156 read_only, unsigned integer
157 Wind direction, using the following table
158 1 N
160 2 NNE
162 3 NE
164 4 NEE
166 5 E
168 6 EES
170 7 ES
172 8 ESS
174 9 S
176 10 SSW
178 11 SW
180 12 SWW
182 13 W
184 14 WWN
186 15 WN
188 16 WWN
190 Values are adjusted (internally) by the WS603/calibration/direction
192 property
193 WS603/volt
195 read-only, unsigned integer
196 Voltage value from the WS603 device. Units and significance is unclear.
197 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 WS603/calibration/direction
204 read-write, unsigned integer
205 Adjustment of wind direction. See datasheet.
206 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 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 Value is set as value 4 of the array passed to WS603/LED/control
218 WS603/LED/status
220 read-only, unsigned integer
221 Status of LED lights intensities. See datasheet.
222 Value is set as values 2 and 3 of the array passed to WS603/LED/control
224 WS603/LED/model
226 read-only, unsigned integer
227 What factors control LED display. See datasheet.
228 Value is set as value 1 of the array passed to WS603/LED/control.ALL
230 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 0 Light mode
237 1 Light status
239 2 Light level
241 3 Light threshold
243
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 defaultpmod defaultswen
253 read-write, yes-no
254 Default power-on state for the corresponding properties.
255
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 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 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 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 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 present (DEPRECATED)
297 read-only, yes-no
298 Is the device currently present on the 1-wire bus?
299 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
306 None.
307
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 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 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 Bus masters come in a variety of configurations including serial, par‐
326 allel, i2c, network or USB adapters.
327 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 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 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 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 For an explanation of the differences between the DS276x variants, see
353 Dallas Application Note 221.
354
356 All 1-wire devices are factory assigned a unique 64-bit address. This
357 address is of the form:
358 Family Code
360 8 bits
361 Address
363 48 bits
364 CRC 8 bits
366 Addressing under OWFS is in hexidecimal, of form:
368 01.123456789ABC
370 where 01 is an example 8-bit family code, and 12345678ABC is an example
372 48 bit address.
373 The dot is optional, and the CRC code can included. If included, it
375 must be correct.
376
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
384 Programs
385 owfs (1) owhttpd (1) owftpd (1) owserver (1) owdir (1) owread (1)
386 owwrite (1) owpresent (1) owtap (1)
387 Configuration and testing
389 owfs (5) owtap (1) owmon (1)
390 Language bindings
392 owtcl (3) owperl (3) owcapi (3)
393 Clocks
395 DS1427 (3) DS1904 (3) DS1994 (3) DS2404 (3) DS2404S (3) DS2415 (3)
396 DS2417 (3)
397 ID
399 DS2401 (3) DS2411 (3) DS1990A (3)
400 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 Switches
407 DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
408 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 [1m(3)
414 Humidity
416 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
417 Voltage
419 DS2450 (3)
420 Resistance
422 DS2890 (3)
423 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 Counter
429 DS2423 (3)
430 LCD Screen
432 LCD (3) DS2408 (3)
433 Crypto
435 DS1977 (3)
436 Pressure
438 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
439 Moisture
441 EEEF (3) DS2438 (3)
442
444 http://www.owfs.org
445
447 Paul Alfille (paul.alfille@gmail.com)
448OWFS Manpage 2003 DS2760(3)