1DS2506(3) One-Wire File System DS2506(3)
2
6 DS2506, DS2506-UNW - Add-Only Memory (64 kBit), UniqueWare Add-Only
7 Memory (64 kBit)
8 DS1986, DS1986U
10 - Add-Only iButton (64 kBit), UniqueWare iButton (64 kBit)
11
13 EPROM add-only memory.
14 0F [.]XXXXXXXXXXXX[XX][/[ memory | pages/page.[0-255|ALL] | address |
16 crc8 | id | locator | r_address | r_id | r_locator | type ]]
17 8F [.]XXXXXXXXXXXX[XX][/[ memory | pages/page.[0-255|ALL] | address |
19 crc8 | id | locator | r_address | r_id | r_locator | type ]]
20
22 0F DS2506 DS1986
23 8F DS2506-UNW DS1986U
25
27 memory
28 read-write, binary
29 8192 bytes of memory. Initially all bits are set to 1. Writing zero
30 permanently alters the memory.
31 pages/page.0 ... pages/page.255 pages/page.ALL
33 read-write, yes-no
34 Memory is split into 256 pages of 32 bytes each. ALL is an aggregate
35 of 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 hexadecimal 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 up‐
51 per case hexadecimal 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 hexadecimal 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 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 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 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 en‐
100 cryption 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 in‐
113 dividual properties of the device are represented as simple files that
114 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 fundamental goal has been ease of use, flexibil‐
122 ity and correctness rather than speed.
123 DS2506 DS1986
125 The DS2506 (3) is used for write-once incremental storage. It's main
126 advantage is for audit trails (i.e. a digital purse).
127 The DS2506-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 hexadecimal, 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/DS2506.pdf
158 http://pdfserv.maxim-ic.com/en/ds/DS2502-UNW-DS2506S-UNW.pdf
159 http://pdfserv.maxim-ic.com/en/ds/DS1986-F3-DS1986-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) In‐
187 fernoEmbedded (3)
188 Temperature
190 DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
191 DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
192 EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3) EDS0072 (3) MAX31826
193 [1m(3)
194 Humidity
196 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
197 Voltage
199 DS2450 (3)
200 Resistance
202 DS2890 (3)
203 Multifunction (current, voltage, temperature)
205 DS2436 (3) DS2437 (3) DS2438 (3) DS2751 (3) DS2755 (3) DS2756 (3)
206 DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
207 Counter
209 DS2423 (3)
210 LCD Screen
212 LCD (3) DS2408 (3)
213 Crypto
215 DS1977 (3)
216 Pressure
218 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
219 Moisture
221 EEEF (3) DS2438 (3)
222
224 http://www.owfs.org
225
227 Paul Alfille (paul.alfille@gmail.com)
228OWFS Manpage 2003 DS2506(3)