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

NAME

6       DS2506,  DS2506-UNW  -  Add-Only  Memory (64 kBit), UniqueWare Add-Only
7       Memory (64 kBit)
8
9       DS1986, DS1986U
10              - Add-Only iButton (64 kBit), UniqueWare iButton (64 kBit)
11

SYNOPSIS

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

FAMILY CODE

22       0F     DS2506 DS1986
23
24       8F     DS2506-UNW DS1986U
25

SPECIAL PROPERTIES

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
32   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

STANDARD PROPERTIES

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
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 up‐
51       per 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  en‐
100       cryption 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 in‐
113       dividual  properties of the device are represented as simple files that
114       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   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
128       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

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/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

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) In‐
187       fernoEmbedded (3)
188
189   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       (3)
194
195   Humidity
196       DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
197
198   Voltage
199       DS2450 (3)
200
201   Resistance
202       DS2890 (3)
203
204   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
208   Counter
209       DS2423 (3)
210
211   LCD Screen
212       LCD (3) DS2408 (3)
213
214   Crypto
215       DS1977 (3)
216
217   Pressure
218       DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
219
220   Moisture
221       EEEF (3) DS2438 (3)
222

AVAILABILITY

224       http://www.owfs.org
225

AUTHOR

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