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

NAME

6       DS2430A, DS1971 - 256-bit 1-wire EEPROM, 256-bit EEPROM ibutton
7

SYNOPSIS

9       EEPROM
10
11       14  [.]XXXXXXXXXXXX[XX][/[  application  |  status | memory | address |
12       crc8 | id | locator | r_address | r_id | r_locator | type ]]
13

FAMILY CODE

15       14
16

SPECIAL PROPERTIES

18   application
19       read-write, binary
20       8 bytes of data. Write once, then status is 0xFC and further writing is
21       impossible.
22
23   status
24       read-only, unsigned integer
25       Is the application area locked?
26
27       0xFF   Application area untouched
28
29       0xFC   Applcation area locked
30
31   memory
32       read-write, binary
33       32 bytes of data. (256 bits)
34

STANDARD PROPERTIES

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

ALARMS

85       None.
86

DESCRIPTION

88   1-Wire
89       1-wire is a wiring protocol and series of devices designed and manufac‐
90       tured by Dallas Semiconductor, Inc. The bus is  a  low-power  low-speed
91       low-connector scheme where the data line can also provide power.
92
93       Each  device  is  uniquely and unalterably numbered during manufacture.
94       There are a wide variety of devices, including memory, sensors  (humid‐
95       ity, temperature, voltage, contact, current), switches, timers and data
96       loggers. More complex devices (like thermocouple sensors) can be  built
97       with  these  basic  devices.  There  are  also 1-wire devices that have
98       encryption included.
99
100       The 1-wire scheme uses a single bus master and multiple slaves  on  the
101       same  wire.  The bus master initiates all communication. The slaves can
102       be individually discovered and addressed using their unique ID.
103
104       Bus masters come in a variety of configurations including serial,  par‐
105       allel, i2c, network or USB adapters.
106
107   OWFS design
108       OWFS  is  a  suite of programs that designed to make the 1-wire bus and
109       its devices easily accessible. The underlying principle is to create  a
110       virtual  filesystem,  with  the  unique ID being the directory, and the
111       individual properties of the device are  represented  as  simple  files
112       that can be read and written.
113
114       Details  of  the  individual slave or master design are hidden behind a
115       consistent interface. The goal is to provide an easy set of tools for a
116       software  designer  to create monitoring or control applications. There
117       are some performance enhancements in the implementation, including data
118       caching, parallel access to bus masters, and aggregation of device com‐
119       munication. Still the fundemental goal has been ease of use,  flexibil‐
120       ity and correctness rather than speed.
121
122   DS2430A
123       The  DS2430A (3) is a memory 1-wire chip. It is considered obsolete and
124       newer designs are supposed to use the DS2431 (3)
125
126       The DS1971 (3) is an iButton version of the same device.
127

ADDRESSING

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

DATASHEET

151       http://pdfserv.maxim-ic.com/en/ds/DS2430A-DS2430AP.pdf
152

SEE ALSO

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

AVAILABILITY

214       http://www.owfs.org
215

AUTHOR

217       Paul Alfille (paul.alfille@gmail.com)
218
219
220
221OWFS Manpage                         2003                           DS2430A(3)
Impressum