1DS2430A(3) One-Wire File System DS2430A(3)
2
3
4
6 DS2430A, DS1971 - 256-bit 1-wire EEPROM, 256-bit EEPROM ibutton
7
9 EEPROM
10
11 14 [.]XXXXXXXXXXXX[XX][/[ application | status | memory | address |
12 crc8 | id | locator | r_address | r_id | r_locator | type ]]
13
15 14
16
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
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 hexadecimal 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 hexadecimal 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 hexadecimal 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 hexadecimal) 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
85 None.
86
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 fundamental 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
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 hexadecimal, 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
151 http://pdfserv.maxim-ic.com/en/ds/DS2430A-DS2430AP.pdf
152
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 [1m(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
214 http://www.owfs.org
215
217 Paul Alfille (paul.alfille@gmail.com)
218
219
220
221OWFS Manpage 2003 DS2430A(3)