1DS2505(3) One-Wire File System DS2505(3)
2
6 DS2505, DS2505-UNW - Add-Only Memory (16 kBit), UniqueWare Add-Only
7 Memory (16 kBit)
8 DS1985, DS1985U
10 - Add-Only iButton (16 kBit), UniqueWare iButton (16 kBit)
11
13 EPROM add-only memory.
14 0B [.]XXXXXXXXXXXX[XX][/[ memory | pages/page.[0-63|ALL] | address |
16 crc8 | id | locator | r_address | r_id | r_locator | type ]]
17 8B [.]XXXXXXXXXXXX[XX][/[ memory | pages/page.[0-63|ALL] | address |
19 crc8 | id | locator | r_address | r_id | r_locator | type ]]
20
22 0B DS2505 DS1985
23 8B DS2505-UNW DS1985U
25
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 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
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 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 hexidecimal digits (0-9A-F).
52 family
54 read-only, ascii
55 The 8-bit family code. Unique to each type of device. Given as upper
56 case hexidecimal digits (0-9A-F).
57 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 hexidecimal 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 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 hexidecimal) 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 present (DEPRECATED)
78 read-only, yes-no
79 Is the device currently present on the 1-wire bus?
80 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
87 None.
88
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 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 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 Bus masters come in a variety of configurations including serial, par‐
107 allel, i2c, network or USB adapters.
108 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 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 fundemental goal has been ease of use, flexibil‐
122 ity and correctness rather than speed.
123 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 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
135 All 1-wire devices are factory assigned a unique 64-bit address. This
136 address is of the form:
137 Family Code
139 8 bits
140 Address
142 48 bits
143 CRC 8 bits
145 Addressing under OWFS is in hexidecimal, of form:
147 01.123456789ABC
149 where 01 is an example 8-bit family code, and 12345678ABC is an example
151 48 bit address.
152 The dot is optional, and the CRC code can included. If included, it
154 must be correct.
155
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
163 Programs
164 owfs (1) owhttpd (1) owftpd (1) owserver (1) owdir (1) owread (1)
165 owwrite (1) owpresent (1) owtap (1)
166 Configuration and testing
168 owfs (5) owtap (1) owmon (1)
169 Language bindings
171 owtcl (3) owperl (3) owcapi (3)
172 Clocks
174 DS1427 (3) DS1904 (3) DS1994 (3) DS2404 (3) DS2404S (3) DS2415 (3)
175 DS2417 (3)
176 ID
178 DS2401 (3) DS2411 (3) DS1990A (3)
179 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 Switches
186 DS2405 (3) DS2406 (3) DS2408 (3) DS2409 (3) DS2413 (3) DS28EA00 (3)
187 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 [1m(3)
193 Humidity
195 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
196 Voltage
198 DS2450 (3)
199 Resistance
201 DS2890 (3)
202 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 Counter
208 DS2423 (3)
209 LCD Screen
211 LCD (3) DS2408 (3)
212 Crypto
214 DS1977 (3)
215 Pressure
217 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
218 Moisture
220 EEEF (3) DS2438 (3)
221
223 http://www.owfs.org
224
226 Paul Alfille (paul.alfille@gmail.com)
227OWFS Manpage 2003 DS2505(3)