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 hexadecimal 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 up‐
49 per 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 en‐
98 cryption 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 in‐
111 dividual properties of the device are represented as simple files that
112 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) In‐
178 fernoEmbedded (3)
179
180 Temperature
181 DS1822 (3) DS1825 (3) DS1820 (3) DS18B20 (3) DS18S20 (3) DS1920 (3)
182 DS1921 (3) DS1821 (3) DS28EA00 (3) DS28E04 (3) EDS0064 (3) EDS0065 (3)
183 EDS0066 (3) EDS0067 (3) EDS0068 (3) EDS0071 (3) EDS0072 (3) MAX31826
184 [1m(3)
185
186 Humidity
187 DS1922 (3) DS2438 (3) EDS0065 (3) EDS0068 (3)
188
189 Voltage
190 DS2450 (3)
191
192 Resistance
193 DS2890 (3)
194
195 Multifunction (current, voltage, temperature)
196 DS2436 (3) DS2437 (3) DS2438 (3) DS2751 (3) DS2755 (3) DS2756 (3)
197 DS2760 (3) DS2770 (3) DS2780 (3) DS2781 (3) DS2788 (3) DS2784 (3)
198
199 Counter
200 DS2423 (3)
201
202 LCD Screen
203 LCD (3) DS2408 (3)
204
205 Crypto
206 DS1977 (3)
207
208 Pressure
209 DS2406 (3) TAI8570 (3) EDS0066 (3) EDS0068 (3)
210
211 Moisture
212 EEEF (3) DS2438 (3)
213
215 http://www.owfs.org
216
218 Paul Alfille (paul.alfille@gmail.com)
219
220
221
222OWFS Manpage 2003 DS2430A(3)