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

NAME

6       DS2505,  DS2505-UNW  -  Add-Only  Memory (16 kBit), UniqueWare Add-Only
7       Memory (16 kBit)
8
9       DS1985, DS1985U
10              - Add-Only iButton (16 kBit), UniqueWare iButton (16 kBit)
11

SYNOPSIS

13       EPROM add-only memory.
14
15       0B [.]XXXXXXXXXXXX[XX][/[ memory | pages/page.[0-63|ALL]  |  address  |
16       crc8 | id | locator | r_address | r_id | r_locator | type ]]
17
18       8B  [.]XXXXXXXXXXXX[XX][/[  memory  | pages/page.[0-63|ALL] | address |
19       crc8 | id | locator | r_address | r_id | r_locator | type ]]
20

FAMILY CODE

22       0B     DS2505 DS1985
23
24       8B     DS2505-UNW DS1985U
25

SPECIAL PROPERTIES

27   memory
28       read-write, binary
29       2048 bytes of memory. Initially all bits are set  to  1.  Writing  zero
30       permanently alters the memory.
31
32   pages/page.0 ... pages/page.63 pages/page.ALL
33       read-write, yes-no
34       Memory is split into 64 pages of 32 bytes each.  ALL is an aggregate of
35       the pages. Each page is accessed sequentially.
36

STANDARD PROPERTIES

38   address
39   r_address
40       read-only, ascii
41       The entire 64-bit unique ID. Given as  upper  case  hexidecimal  digits
42       (0-9A-F).
43       address starts with the family code
44       r address is the address in reverse order, which is often used in other
45       applications and labeling.
46
47   crc8
48       read-only, ascii
49       The 8-bit error correction portion. Uses cyclic redundancy check.  Com‐
50       puted  from  the  preceding  56  bits of the unique ID number. Given as
51       upper case hexadecimal digits (0-9A-F).
52
53   family
54       read-only, ascii
55       The 8-bit family code. Unique to each type of device.  Given  as  upper
56       case hexadecimal digits (0-9A-F).
57
58   id
59   r_id
60       read-only, ascii
61       The 48-bit middle portion of the unique ID number. Does not include the
62       family code or CRC. Given as upper case hexadecimal digits (0-9A-F).
63       r id is the id in reverse order, which is often used in other  applica‐
64       tions and labeling.
65
66   locator
67   r_locator
68       read-only, ascii
69       Uses  an  extension  of the 1-wire design from iButtonLink company that
70       associated 1-wire physical connections with a unique  1-wire  code.  If
71       the  connection is behind a Link Locator the locator will show a unique
72       8-byte number (16 character hexadecimal) starting with family code FE.
73       If no Link Locator is between the device and the  master,  the  locator
74       field will be all FF.
75       r locator is the locator in reverse order.
76
77   present (DEPRECATED)
78       read-only, yes-no
79       Is the device currently present on the 1-wire bus?
80
81   type
82       read-only, ascii
83       Part  name  assigned by Dallas Semi. E.g.  DS2401 Alternative packaging
84       (iButton vs chip) will not be distiguished.
85

ALARMS

87       None.
88

DESCRIPTION

90   1-Wire
91       1-wire is a wiring protocol and series of devices designed and manufac‐
92       tured  by  Dallas  Semiconductor, Inc. The bus is a low-power low-speed
93       low-connector scheme where the data line can also provide power.
94
95       Each device is uniquely and unalterably  numbered  during  manufacture.
96       There  are a wide variety of devices, including memory, sensors (humid‐
97       ity, temperature, voltage, contact, current), switches, timers and data
98       loggers.  More complex devices (like thermocouple sensors) can be built
99       with these basic devices. There  are  also  1-wire  devices  that  have
100       encryption included.
101
102       The  1-wire  scheme uses a single bus master and multiple slaves on the
103       same wire. The bus master initiates all communication. The  slaves  can
104       be individually discovered and addressed using their unique ID.
105
106       Bus  masters come in a variety of configurations including serial, par‐
107       allel, i2c, network or USB adapters.
108
109   OWFS design
110       OWFS is a suite of programs that designed to make the  1-wire  bus  and
111       its  devices easily accessible. The underlying principle is to create a
112       virtual filesystem, with the unique ID being  the  directory,  and  the
113       individual  properties  of  the  device are represented as simple files
114       that can be read and written.
115
116       Details of the individual slave or master design are  hidden  behind  a
117       consistent interface. The goal is to provide an easy set of tools for a
118       software designer to create monitoring or control  applications.  There
119       are some performance enhancements in the implementation, including data
120       caching, parallel access to bus masters, and aggregation of device com‐
121       munication.  Still the fundamental goal has been ease of use, flexibil‐
122       ity and correctness rather than speed.
123
124   DS2505 DS1985
125       The DS2505 (3) is used for write-once incremental  storage.  It's  main
126       advantage is for audit trails (i.e. a digital purse).
127
128       The  DS2505-UNW  is one of the UniqueWare class of devices. Some of the
129       memory  was  preprogramed  at  the  factory.  See  the  datasheet   for
130       specifics. The DS2502 , DS2505 , and DS2506 differ in their function by
131       the amount of on-board memory they possess. (The internal protocols are
132       slightly different, but the OWFS system handles this automatically.
133

ADDRESSING

135       All  1-wire  devices are factory assigned a unique 64-bit address. This
136       address is of the form:
137
138       Family Code
139              8 bits
140
141       Address
142              48 bits
143
144       CRC    8 bits
145
146       Addressing under OWFS is in hexadecimal, of form:
147
148              01.123456789ABC
149
150       where 01 is an example 8-bit family code, and 12345678ABC is an example
151       48 bit address.
152
153       The  dot  is  optional,  and the CRC code can included. If included, it
154       must be correct.
155

DATASHEET

157       http://pdfserv.maxim-ic.com/en/ds/DS2505.pdf
158       http://pdfserv.maxim-ic.com/en/ds/DS2502-UNW-DS2506S-UNW.pdf
159       http://pdfserv.maxim-ic.com/en/ds/DS1985-F3-DS1985-F5.pdf
160       http://pdfserv.maxim-ic.com/en/ds/DS1982U-DS1986U.pdf
161

SEE ALSO

163   Programs
164       owfs (1) owhttpd (1) owftpd (1)  owserver  (1)  owdir  (1)  owread  (1)
165       owwrite (1) owpresent (1) owtap (1)
166
167   Configuration and testing
168       owfs (5) owtap (1) owmon (1)
169
170   Language bindings
171       owtcl (3) owperl (3) owcapi (3)
172
173   Clocks
174       DS1427  (3)  DS1904  (3)  DS1994  (3) DS2404 (3) DS2404S (3) DS2415 (3)
175       DS2417 (3)
176
177   ID
178       DS2401 (3) DS2411 (3) DS1990A (3)
179
180   Memory
181       DS1982 (3) DS1985 (3) DS1986 (3)  DS1991  (3)  DS1992  (3)  DS1993  (3)
182       DS1995  (3)  DS1996  (3)  DS2430A  (3) DS2431 (3) DS2433 (3) DS2502 (3)
183       DS2506 (3) DS28E04 (3) DS28EC20 (3)
184
185   Switches
186       DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
187
188   Temperature
189       DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3)  DS18S20  (3)  DS1920  (3)
190       DS1921  (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
191       EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3)  EDS0072  (3)  MAX31826
192       (3)
193
194   Humidity
195       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
196
197   Voltage
198       DS2450 (3)
199
200   Resistance
201       DS2890 (3)
202
203   Multifunction (current, voltage, temperature)
204       DS2436  (3)  DS2437  (3)  DS2438  (3)  DS2751 (3) DS2755 (3) DS2756 (3)
205       DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
206
207   Counter
208       DS2423 (3)
209
210   LCD Screen
211       LCD (3) DS2408 (3)
212
213   Crypto
214       DS1977 (3)
215
216   Pressure
217       DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
218
219   Moisture
220       EEEF (3) DS2438 (3)
221

AVAILABILITY

223       http://www.owfs.org
224

AUTHOR

226       Paul Alfille (paul.alfille@gmail.com)
227
228
229
230OWFS Manpage                         2003                            DS2505(3)
Impressum